Customer Management Biz Api

Create customer for FIXED

This operation creates a customer entity.

Key Design Decisions for CR Market

• New B2C customers are in scope.
• name field in the request is a combination of firstName + lastName + lastName2 from characteristics
• Mulesoft is converting the values to upper case as per the validation of siebel.
• No data validation is present in the Mulesoft. Possible values in the documentation are not final. Consumer should validate all the possible values based on the business requirement.
• Error message from the backend system is captured in the error response.
• The legacy system that consumes the creation of the customer must respect the values of the lists of values configured in the fields.
• The customer creation web service will only allow the creation of 1 customer at a time.
• The value for the "Identification number" field may be sent with or without hyphens (-), always respecting the minimum and maximum number of characters and other format validations.
• The customer creation process will create an address record with the information provided, this record will be assigned as the main address. The system that consumes the web service must send the correct values from the province, canton, district and neighborhood value lists.
• The system will return an error code and message in case there is a problem creating and associating the new address and/or contact record, but the customer creation will not be interrupted. In the case of error (error in address or contact), the creation of these records will be done manually by the end user.
• Reprocessing of request is not possible if the customer entity creation is successful.-Refer Request and Response with Name CR-B2C-Contact Id(contactId), Row Id (id) and Address Id(addressId) are required to Create Agreement, settlementAccount and to create Order-amnistia value should be empty,when “idProofType = CEDULA FISICA” or PASAPORTE

Characteristic Sub-Resource Table for request for CR Market

Characteristic Sub-Resource Table for response for CR Market

Error Scenarios examples:

Reason: when name is missing

    {
  "errors": [
    {
      "code": 400,
      "message": "APIKIT:BAD_REQUEST",
      "description": "required key [name] not found"
    }
  ]
}

Reason: when email characteristic.emailAddress value is invalid

    {
  "errors": [
    {
      "code": 400,
      "message": "Correo invalido(SBL-EXL-00151)(SBL-EXL-00151)",
      "description": "RowId: null,contactId: null,addressId: null"
    }
  ]
}

Reason: when address characteristic.city is missing

    {
  "errors": [
    {
      "code": 400,
      "message": "VALIDATION_CREATECUSTOMER:FAILED",
      "description": "City is mandatory"
    }
  ]
}

Reason: when address characteristic.stateOrProvince is missing

{

"errors": [

{

"code": 400,

"message": "VALIDATION_CREATECUSTOMER:FAILED",

"description": "State or province is mandatory"

}

]

}

Reason: when address characteristic.street1 is missing

    {
  "errors": [
    {
      "code": 400,
      "message": "VALIDATION_CREATECUSTOMER:FAILED",
      "description": "Street1 is mandatory"
    }
  ]
}

Reason: when characteristic.idProof is missing

{
  "errors": [
    {
      "code": 400,
      "message": "VALIDATION_CREATECUSTOMER:FAILED",
      "description": "IdProof is mandatory"
    }
  ]
}

Reason : when characteristic.idProofType value is invalid

    {
  "errors": [
    {
      "code": 400,
      "message": "El valor del campo Location Type del business component Account no coincide con ningún valor de la lista de selección enlazada Training Location Type Picklist.(SBL-DAT-00225)",
      "description": "RowId: null,contactId: null,addressId: null"
    }
  ]
}

Emarsys POST Customer

Key Points:

1. Its implemented for PR, JM, PA, CR Markets.
2. ChannelId headers should be pass as "ECOM"
3. targetSystem headers should be pass as "emarsys"

Request body:

{
    "contactMedium": [
        {
            "preferred": true,
            "characteristic": {
                "emailAddress": "kadambini.chandel@capgemini.com"
            }
        }
    ]
}

Response Body:

{
    "id": 671517439
}

POST Customer for PA:

Request body:

{
    "name": "TEST 25Feb2022",
    "contactMedium": [
        {
            "mediumType": "Address",
            "preferred": false,
            "characteristic": {
                "street1": "512",
                "street2": "Boulevard CostaDeleste",
                "city": "PHCountryClub CostaDelEste",
                "stateOrProvince": "Juan Dias",
                "postCode": "00000",
                "country": "Panama"
            }
        },
        {
            "mediumType": "Telephone",
            "preferred": true,
            "characteristic": {
                "phoneNumber": "1234566789",
                "contactType": "mobile/home"
            }
        },
        {
            "mediumType": "Mobile",
            "preferred": true,
            "characteristic": {
                "phoneNumber": "1234566789",
                "contactType": "mobile1/mobile2"
            }
        },
        {
            "mediumType": "Email",
            "preferred": false,
            "characteristic": {
                "emailAddress": "donald.slicon@silicon.com",
                "contactType": "email"
            }
        }
    ],
    "characteristic": [
        {
            "name": "dateOfBirth",
            "value": "2000-06-12"
        },
        {
            "name": "title",
            "value": "Mr"
        },
        {
            "name": "gender",
            "value": "M"
        },
        {
            "name": "type",
            "value": "RES"
        },
        {
            "name": "companyCode",
            "value": "CWP"
        },
        {
            "name": "idProof",
            "valueType": "C",
            "value": "8-997-999"
        },
        {
            "name": "sourceEPC",
            "value": "LIBERATE"
        },
        {
            "name": "nationality",
            "value": "PANA"
        },
        {
            "name": "employmentStatus",
            "value": "N"
        }
    ]
}

Response Body:

{
    "id": "3391803",
    "account": [
        {
            "id": "339180300000"
        }
    ]
}